home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1994 June: Reference Library / Dev.CD Jun 94.toast / Periodicals / develop / develop Issue 11 / develop 11 code / The NetWork Project / Change History < prev    next >
Encoding:
Text File  |  1992-07-15  |  3.3 KB  |  87 lines  |  [TEXT/ttxt]
  1. Change histories are boring (though necessary). We are not going to give a 
  2. full change history from NetWork package 0.9 (the latest version with wide 
  3. distribution) to 1.2 (the recent one). Instead, we give a short account of 
  4. what we changed, and why.
  5.  
  6.  Major changes:
  7.       - NetWork library and interfaces completeley revised.
  8.       - Lookup utilities are provided in a new unit "NetWorkLookup" 
  9.         and removed from NetWork.p.
  10.       - Queue management for messages has been moved from the Scheduler 
  11.           layer to the NetWork processor, all queue management utilities 
  12.         removed from the 
  13.       - Scheduler buffer management is a dynamic task 
  14.         delegated to the message handlers
  15.  
  16. General:
  17. ========
  18.  
  19. The message record data structure has changed. This affects all parts
  20. of the system. Some component names have been changed, you can use
  21. NetWork.Canon to change these. Some new components have been introduced
  22. that require you to change your code. Some old components have been
  23. removed, requiring changes as well.
  24.  
  25.  
  26. NetWork Processor:
  27. ==================
  28.  
  29. NetWork Processor supports the use of events to signal messages that need
  30. processing. This allows you to remove some housekeeping that you had to
  31. perform previously.
  32.  
  33.  
  34. NetWork Library:
  35. ================
  36.  
  37. Many changes. Library supports interface to events.  
  38.  
  39. GetIndexMsg will be removed in the next version. So far, it is still provided:
  40.     function GetIndexedMsg; (var Msg : MsgPtr; Index : integer;    
  41.         {0=1} PrioData : Ptr; 
  42.         MaxPrioSize : longint) : OSErr;
  43.     GetIndexedMsg returns a pointer to the message indicated by index at Msg. 
  44.     The priority information is read to the area indicated by PrioData and 
  45.     MaxPrioSize. GetIndexedMsg is defunct. Should not be used any more.
  46.  
  47.  
  48. NetWork Name Look-Up:
  49. =====================
  50.  
  51. The name lookup functions have been moved from NetWork.p to a separate unit 
  52. called NetWorkLookup. The default implementation is already contained in 
  53. NetWorkLib.o. Include NetWorkLookUp in your uses-list, but do not recompile 
  54. and link to this unit unless you are using your own lookup system.
  55.  
  56. You´ll have to make provisions to call NlTask regularly.
  57.  
  58. Scheduler:
  59. ==========
  60.  
  61. Message handlers are now dynamic objects, associated to messages. Before,
  62. they wore associated to the scheduler. The message handlers known to the 
  63. scheduler now only operate as default message handlers to be used at first 
  64. sight of a message, and in error situations.
  65.  
  66. The Scheduler now reclaims the MsgUserRefCon field to associate a message 
  67. handler to a message. This field is reserved when used with the Scheduler.
  68.  
  69. The message handler object has been completely rewritten. The old structure
  70. was suggesting a latched buffer strategy, encouraging very poor buffer
  71. strategies. The new structure requests that the implementor specifies the
  72. buffer strategies used by specifying the corresponding constructors and 
  73. destructors. Poor strategies still can be used, but would need considerably
  74. more effort to hide their deficits.
  75.  
  76. The Scheduler has been rewritten; queue maintenance is now provided by the 
  77. NetWork Processor and has been removed from the Scheduler. The use of the
  78. new event-based structure is recommended. The previous queue maintenance by 
  79. the scheduler still can be used, but requires some cut&paste.
  80.  
  81. Examples:
  82. =========
  83.  
  84. All examples have been modified to work with the new release.
  85.  
  86.     
  87.